doc: Minor tweaks

diff --git a/doc/overview.xml b/doc/overview.xml
index 948f5c74dbc130f4322f1d6d2e509165d4e23855..79763b5e6563f5bee8d7ef4fd43a9d6fe836f418 100644 (file)
--- a/doc/overview.xml
+++ b/doc/overview.xml
@@ -79,9 +79,10 @@
       and <emphasis>predictable</emphasis>.
     </para>
     <para>
-      But unlike many default image-based deployments, OSTree
-      supports a persistent, writable <literal>/etc</literal> that
-      is preserved across upgrades.
+      But unlike many default image-based deployments, OSTree supports
+      exactly two persistent writable directories that are preserved
+      across upgrades: <literal>/etc</literal> and
+      <literal>/var</literal>.
     </para>
     <para>
       Because OSTree operates at the Unix filesystem layer, it works

diff --git a/doc/repo.xml b/doc/repo.xml
index dd49c28cbf4fcf4bb9f3203b08b361b688893d7e..5379d3a01fa7e406b307529f8896a76edab615ab 100644 (file)
--- a/doc/repo.xml
+++ b/doc/repo.xml
@@ -8,9 +8,9 @@
   <chapter id="repository-intro">
     <title>Core object types and data model</title>
     <para>
-      OSTree is deeply inspired by git; like git, OSTree is a
-      userspace versioning filesystem.  It is worth taking some time
-      to familiarize yourself with <ulink
+      OSTree is deeply inspired by git; the core layer is a userspace
+      content-addressed versioning filesystem.  It is worth taking
+      some time to familiarize yourself with <ulink
       url="http://git-scm.com/book/en/Git-Internals">Git
       Internals</ulink>, as this section will assume some knowledge of
       how git works.